home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 24 / AACD 24.iso / AACD / Information / WebSites / Eyetech / DOWNLOAD / IOBLI015.LHA / Goodies / SetDevice / README < prev    next >
Text File  |  1999-08-10  |  6KB  |  157 lines
  1.  
  2.                 SetDevice V1.00      11.09.1998
  3.  
  4. Introduction
  5. ------------
  6.  
  7. Using   SetDevice   you   can   define  the  device  used  by  the
  8. printer.device  for  printing, thus removing the need for a device
  9. redirection  program  (for instance MapDevice, NSDPatch).  This is
  10. especialy  usefull  with  IO  boards  like  MultiFace  III, GVP IO
  11. Extender, HyperCOM, IOBlix...  .  Only the output device specified
  12. is  used  by  the printer.device and no other port is blocked from
  13. using because of redirection.
  14.  
  15. Note that since V2.04 the Amiga OS and printer.device does support
  16. printing   to   basicly   any   device.   However,  the  "Printer"
  17. preferences  program does not allow you to alter the output device
  18. setting.   Only the unit of the output device can be altered after
  19. starting  "Printer"  preferences using the UNIT tool type/keyword.
  20. Instead  of  allowing  the  user  to  enter  the device in Printer
  21. preferences,   Commodore   deviced   to  leave  this  job  to  the
  22. programmers  of  the  IO  devices  to  supply  the necessary tool.
  23. However, most of those never did the job.  Using SetDevice you can
  24. alter  the  system  preferences  so  that  the printer.device will
  25. automaticly  use the output device you want.  Stop using MapDevice
  26. and other hacks.
  27.  
  28. Requirements:
  29. -------------
  30.  
  31. Kickstart 2.04 (or later).
  32.  
  33.  
  34. Installation:
  35. -------------
  36.  
  37. Basicly no installation is needed.  However, it is recommended you
  38. do drag the SetDevice program to your systems Prefs drawer.
  39.  
  40.  
  41. Startoptions
  42. ------------
  43.  
  44. SetDevice  can  be  started  from  Workbench  or Shell.  Following
  45. options  can  be provided as shell argument or as tool type (click
  46. ONCE on the programs icon and than use the "Information" menu item
  47. of  the Workbench to access the programs tool types) when starting
  48. from Workbench):
  49.  
  50.  
  51. USE/S and SAVE/S:
  52.  
  53. You  must  specify  at least one of these keywords in order to set
  54. the output device without showing the user interface of SetDevice.
  55. Similar  to preferences editors, USE does only alter the temporary
  56. preferences  in  ENV:   while SAVE also does set the device in the
  57. permanent ENVARC:  preferences file.
  58.  
  59. DEVICE=<devicename>
  60.  
  61. Use  DEVICE  in  order  to  specify  the output device used by the
  62. printer.device for printing.  For instance, MultiFace III users 
  63. can  use:  SetDevice DEVICE=pit.device UNIT=0 SAVE in order to set
  64. the output device for their IO board.
  65.  
  66. UNIT=<unitnumer>
  67.  
  68. Here  you  can  specify  the  output  device unit.  The setting is
  69. identical  to  the Unit setting offered in the Printer preferences
  70. program when starting the preferences program with the UNIT option.
  71.  
  72. PUBSCREEN=<screenname>
  73.  
  74. The  SetDevice window is opened on the default public screen.  You
  75. may  specify  a  special  public  screen  by setting the Tool Type
  76. PUBSCREEN=<screenname>  and  the preferences program will open its
  77. window  on  your application's screen.  If you run the preferences
  78. program  from  a  Shell  you can similar specify a screen with the
  79. PUBSCREEN option.  Note the screen name is case sensitive.
  80.  
  81. TOPAZ:
  82.  
  83. The SetDevice program is font independent, which means it uses any
  84. system  font  you  have  chosen  in Workbench Font preferences for
  85. displaying  the  text  in  gadgets and windows.  You can force the
  86. preferences  programs to always use the topaz 8 font by defining a
  87. TOPAZ Tool Type or Shell keyword.
  88.  
  89.  
  90. Notes
  91. -----
  92.  
  93. SetDevice  is  normaly  part  of  the commercial/shareware printer
  94. software  Studio/CanonStudio.   IOBlix  users are free to also use
  95. this tool.
  96.  
  97. Note that the device name and unit defined by SetDevice is part of
  98. the normal printer preferences setting of your Workbench.  The
  99. settings are stored in the same file as edited by the "Printer"
  100. preferences program.  The "Printer" preferences program usualy
  101. does not change your settings unless you do change the settings in
  102. a  "complete"  manner.   For instance, if you do use the "Reset To
  103. Default"  menu item of the Printer preferences program, it will
  104. also  reset  the  output  device  set  by  the  SetDevice program.
  105. Changing indivual settings in the Printer preferences program will
  106. not harm our output device settings.
  107.  
  108. As you might have noted, SetDevice does not offer a FROM option or
  109. does allow saving the complete preferences.  This is not necessary
  110. as  the  setting  is  stored  in  the  same profile as used by the
  111. Printer  preferences  program.   So  if  you do want to change the
  112. device  setting  based  on a previously saved setting file, simply
  113. use  the  Printer  preferences  program for it.  Otherwise you can
  114. always  use  the DEVICE and UNIT argument with SetDevice to change
  115. the settings in batch files without causing requesters or windows.
  116.  
  117. The device set with SetDevice is always used for output, no matter if
  118. you  specify  Serial  or  Parallel  output in Printer preferences.
  119. Thus  the  default  setting  is  no device name.  In this case the
  120. printer.device    automaticly   refers   to   parallel.device   or
  121. serial.device  depending  on  the  "Printer  Port"  setting in the
  122. Printer preferences program.
  123.  
  124. For those who don't know what device to set for their IO boards:
  125.  
  126. Amiga internal parallel port:  parallel.device
  127. Amiga internal serial port:    serial.device
  128. MultiFace III parallel port:   pit.device
  129. MultiFace III serial ports:    duart.device
  130. GVP IO Extender parallel port: gvppar.device
  131. HyperCom parallel port:        hyperPAR.device
  132. IOBlix:       ioblixpar.device or ioblix12par.device
  133.  
  134. Bugs/Wishes/Contact
  135. -------------------
  136.  
  137. In case you run into problems with this program, contact:
  138.  
  139. Wolf Faust, email: wfaust@compuserve.com
  140.  
  141.  
  142. COPYRIGHT/DISCLAIMER
  143. ====================
  144.  
  145. Copyright   ©1998   Wolf   Faust.    All   rights  reserved.   All
  146. distribution-  and  marketing rights to the software are vested in
  147. Wolf  Faust.   The  software has been provided to you strictly 'as
  148. is',  without  warranty  of  any  kind.   In  no  event  shall the
  149. distributor  and/or  Faust  be held liable for any loss or damages
  150. arising  out  of  any action, from whatever source, concerning the
  151. use  or  inability to use the software.  YOU MAY NOT USE, COPY, OR
  152. TRANSFER  THE  PRODUCT,  OR  ANY  COPY  OR  PORTION, WITHOUT PRIOR
  153. CONSENT IN WRITING FROM WOLF FAUST.
  154.  
  155. More  (c)  1986-1993  Commodore-Amiga,  Inc.  All Rights Reserved.
  156. Reproduced and distributed under license from Commodore.
  157.